Personal Computer World 2009 February/PCWFEB09.iso/Software/Linux/SLAX 6.0.8/slax-6.0.8.iso/slax/base/006-devel.lzm/usr/include/ksslinfodlg.h

C/C++ Source or Header | 2005-10-10 | 5.1 KB | 174 lines

/* This file is part of the KDE project
 *
 * Copyright (C) 2000-2003 George Staikos <[e-mail]>
 * Copyright (C) 2000 Malte Starostik <[e-mail]>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 */

#ifndef _KSSLINFODLG_H
#define _KSSLINFODLG_H

#include <kdialog.h>

#include "ksslx509map.h"
#include "ksslcertificate.h"
#include "kssl.h"
#include <qscrollview.h>

class QWidget;
class KSSLCertBox;
class KSSLCertChain;


/**
 * KDE SSL Information Dialog
 *
 * This class creates a dialog that can be used to display information about
 * an SSL session.
 *
 * There are NO GUARANTEES that KSSLInfoDlg will remain binary compatible/
 * Contact [e-mail] for details if needed.
 *
 * @author George Staikos <[e-mail]>
 * @see KSSL
 * @short KDE SSL Information Dialog
 */
class KIO_EXPORT KSSLInfoDlg : public KDialog {
    Q_OBJECT
public:
    /**
     *  Construct a KSSL Information Dialog
     *
     *  @param secureConnection true if the connection is secured with SSL
     *  @param parent the parent widget
     *  @param name the internal name of this instance
     *  @param modal true if the dialog should be modal
     */
    KSSLInfoDlg(bool secureConnection, QWidget *parent=0L, const char *name=0L, bool modal=false);

    /**
     *  Destroy this dialog
     */
    virtual ~KSSLInfoDlg();

    /**
     *  Tell the dialog if the connection has portions that may not be
     *  secure (ie. a mixture of secure and insecure frames)
     *
     *  @param isIt true if security is in question
     */
    void setSecurityInQuestion(bool isIt);

    /**
     *  Setup the dialog before showing it.
     *
     *  @param cert the certificate presented by the site
     *  @param ip the ip of the remote host
     *  @param url the url being accessed
     *  @param cipher the cipher in use
     *  @param cipherdesc text description of the cipher in use
     *  @param sslversion the version of SSL in use (SSLv2, SSLv3, TLSv1, etc)
     *  @param usedbits the number of bits in the cipher key being used
     *  @param bits the bit-size of the cipher in use
     *  @param certState the certificate state (valid, invalid, etc)
     */
    void setup(KSSLCertificate *cert,
            const QString& ip, const QString& url,
            const QString& cipher, const QString& cipherdesc,
            const QString& sslversion, int usedbits, int bits,
            KSSLCertificate::KSSLValidation certState);

    /**
     *  Setup the dialog before showing it.  This is a convenience version
     *  of the above method, and obtains the same information using the
     *  @param ssl parameter instead.
     *
     *  @param ssl the ssl connection
     *  @param ip the ip of the remote host
     *  @param url the url being accessed
     */
    void setup( KSSL & ssl, const QString & ip, const QString & url );

        /**
         *  Set the errors that were encountered while validating the site
         *  certificate.
         */
        void setCertState(const QString &errorNrs);

    /**
     *  Utility function to generate the widget which displays the detailed
     *  information about an X.509 certificate.
     *
     *  @param parent the parent widget
     *  @param certName the name (subject) of the certificate
     *  @param mailCatcher the class which catches click events on e-mail
     *         addresses
     */
    static KSSLCertBox *certInfoWidget(QWidget *parent, const QString &certName, QWidget *mailCatcher=0);

private:
    QScrollView *buildCertInfo(const QString &certName);
    void displayCert(KSSLCertificate *x);

    class KSSLInfoDlgPrivate;
    KSSLInfoDlgPrivate *d;

private slots:
    void launchConfig();
    void urlClicked(const QString &url);
    void mailClicked(const QString &url);
    void slotChain(int x);
};


/**
 * KDE SSL Certificate Box
 *
 * This class creates a widget which formats and displays the contents of an
 * SSL X.509 certificate.  That is, it takes the "subject" of the certificate
 * and displays everything contained therein.
 *
 * @author George Staikos <[e-mail]>
 * @see KSSLInfoDlg
 * @short KDE SSL Certificate Box
 */
class KIO_EXPORT KSSLCertBox : public QScrollView {
public:
    /**
     *  Construct a certificate box
     *
     *  @param parent the parent widget
     *  @param name the internal name of this instance
     *  @param f widget flags for the object
     */
    KSSLCertBox(QWidget *parent=0L, const char *name=0L, WFlags f=0);

    /**
     *  Change the contents of the widget
     *
     *  @param certName the name ("subject") of the certificate
     *  @param mailCatcher the widget which catches the url open events
     */
    void setValues(QString certName, QWidget *mailCatcher=0L);

private:
    QFrame *_frame;
};

#endif